home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1996 April / Software of the Month Club 1996 April.iso / pc / os2 / psutils / readme.os2 < prev   
Text File  |  1996-02-21  |  3KB  |  95 lines
  1. This archive includes OS/2 executables and sources of Angus Duggan's
  2. PostScript Utilities for manipulating PostScript documents.
  3.  
  4. Included executables were compiled with emx/gcc 0.9b Fix level 1.
  5. The original sources (Release 1 Patchlevel 16) are included in this 
  6. archive in the src/ subdir.
  7.  
  8. The latest updates of the original PSUtils sources are available from:
  9.  
  10.     ftp.dcs.ed.ac.uk: /pub/ajcd/psutils.tar.Z
  11.  
  12. Refer to docs in src\ and man\ for any details about PSUtils, and contact
  13. the author, Angus Duggan (angus@harlequin.co.uk), for any bug fixes and
  14. suggestions to PSUtils.
  15.  
  16. LIST OF FILES:
  17. --------------
  18.  
  19.     ------------------------------------------------------------------
  20.     bin-emx/*        OS/2 executables that may(?) also work under DOS
  21.     bin-os2/*        OS/2 executables
  22.     cmd/*        OS/2 .cmd scripts that require GNU Perl v5.x
  23.     man/*        Manual pages
  24.     src/*        Original source codes of Release 1 Patchlevel 16
  25.     Makefile.emx    Makefile to build bin-emx/*.exe
  26.     Makefile.os2    Makefile to build bin-os2/*.exe
  27.     maketext.os2    Modified src\maketext to create *.cmd for Perl 5.x
  28.     ------------------------------------------------------------------
  29.  
  30.     Executables require EMX runtime package written by Eberhard Mattes, and
  31.     .cmd files require GNU Perl v5.x (or later) ported by Kai Uwe Rommel.
  32.     Those packages are available at
  33.  
  34.     hobbes.nmsu.edu:
  35.     /os2/unix/emx09b/emxrt.zip (EMX runtime package)
  36.     /os2/unix/perl501m.zip (Perl 5.01 langauge interpreter)
  37.  
  38.  
  39. HOW TO REBUILD:
  40. ---------------
  41.  
  42.   Using emx/gcc and GNU make (under OS/2 CMD shell):
  43.     1. Copy maketext.os2 to src\ subdir
  44.     2. From src\ subdir, using GNU make, run
  45.  
  46.     make -f ../makefile.os2
  47.  
  48.        to create OS/2 executables, or
  49.  
  50.     make -f ../makefile.emx
  51.  
  52.        to create DOS and OS/2 bound executables that can hopely run under DOS.
  53.  
  54.     These makefiles were based on src\Makefile.os2 and src\Makefile.unix.
  55.     (I also corrected a few things so that it can work under OS/2 CMD shell.)
  56.  
  57.   Makefiles for some other compilers/platforms are in src\ dir.
  58.  
  59.  
  60. INSTALLATION NOTES:
  61. -------------------
  62.  
  63.     Executables can run under OS/2 CMD shell alone.  However, included
  64.     *.cmd require you to install GNU Perl 5.x (ported by Kai Uwe Rommel)
  65.     and a unix shell (named 'sh').  *.cmd should run under OS/2 CMD shell.
  66.  
  67.     Default installation would be
  68.     1. copy executables and *.cmd in \psutils and put it in PATH
  69.     2. copy src\*.ps to \lib\psutils
  70.  
  71.     However, you may put them in other dir:
  72.  
  73.     If you want to put *.cmd in other dir in PATH, update two .cmd files
  74.     (getafm.cmd and showchar.cmd) that use 'sh' (a unix shell) as they are
  75.     supposed to be placed in \psutils dir.  For instance, to move .cmd to 
  76.     f:\cmd (in PATH), update the first line of showchar.cmd:
  77.     extproc sh \psutils\showchar.cmd
  78.     to
  79.     extproc sh f:\cmd\showchar.cmd
  80.  
  81.     Similarly update getafm.cmd as well.
  82.  
  83.     And, update the line '$dir = "/lib/psutils";' in fixmacps.cmd if you
  84.     wish to put *.ps in some other dir.
  85.  
  86.     Other .cmd files don't need any modifications by these dir changes.
  87.  
  88.     Note that the Perl executable names in *.cmd are 'perl5' instead of
  89.     'perl'; you may change all 'perl5' in *.cmd to 'perl' if you need.
  90.  
  91.     Refer docs of PSUtils for further details.
  92.  
  93. --
  94. Wonkoo Kim (wkim+@pitt.edu), December 30, 1995
  95.